Magnum One/Magnum One (Mid-American Digital) (Disc Manufacturing).iso/d21/dvcpy050.arc/DVCOPY.DOC

Text File | 1991-12-26 | 19KB | 619 lines

            ──╥─────┐  ╥     ┬  ╓─────┐  ╓─────┐  ╥─────┐  ╥     ┬
              ║     │  ║     │  ║        ║     │  ║     │  ║     │
              ║     │  ║   ┌─┘  ║        ║     │  ╟─────┘  ╙─────┤
              ║     │  ║   │    ║        ║     │  ║              │
            ──╨─────┘  ╙───┘    ╙─────┘  ╙─────┘  ╨        ╙─────┘


                                 Version 0.50

                      DESQview and SHARE aware copy clone

            (c) 1991, YossiWare Developments. All Rights Reserved.


























  DVCopy 0.50       DESQview and SHARE Aware Copy Command       USER MANUAL















       ┌─────┬──────────────────────────────────────────────────────────┐
       │ 1.0 │░░░ LICENSING, DISTRIBUTING AND WARRANTY ░░░░░░░░░░░░░░░░░│
       └─────┴──────────────────────────────────────────────────────────┘

       DVCopy is provided  as-is. You may use it  freely, and distribute
       it freely, as long  as you do not modify or delete  any or all of
       the files included with it.

       DVCopy is  not a free software.  After some time you  use it, you
       are requested to  pay for it. Commercial use  of it is premitted,
       but requires commercial (or semi-commercial) registration.

       Any  use of  DVCopy for  making money  is considered  commercial.
       Full commercial registration  is needed when you run  DVCopy in a
       commercial   environment    (store,   company).   Semi-commercial
       registration is required when you  run DVCopy in a non-commercial
       environment, but for commercial use.

       Please support  hours of writing,  testing and debugging  DVCopy,
       by registering.  It is your  registrations that will  keep DVCopy
       alive !

       DVCopy  comes with  no warranty.  We are  not responsible for any
       damage or  loss of data DVCopy  may cause. It uses  many critical
       coding in  it, including direct  assembly coding, which  makes it
       small, optimized, but sensitive. It  is possible that DVCopy will
       cause your  system to hung,  or will copy  the files incorrectly,
       although in none of our tests it did so.

















                                     - 2 -
  DVCopy 0.50       DESQview and SHARE Aware Copy Command       USER MANUAL





       ┌─────┬──────────────────────────────────────────────────────────┐
       │ 2.0 │░░░ INTRODUCTION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
       └─────┴──────────────────────────────────────────────────────────┘


       DVCopy is a clone of the MS-DOS COPY command. It was particularly
       designed  to be  used under  DESQview. If  using it under regualr
       single-tasking MS-DOS environment, it  will act like normal COPY.
       When  DESQview   is  detected,  DVCopy   will  use  sophisticated
       techniques to be both efficient and safe.

       Note that it  can also be used under  local networks, which, like
       DESQview, require file sharing routines.

       DVCopy  is capable  of using  a floppy  drive without causing the
       other tasks  to almost-freeze. The  copy speed will  be affected,
       ofcourse. The  priority DVCopy gives to  DESQview is configurable
       as "Floppy Protection Level", and is discussed later.












       ┌─────┬──────────────────────────────────────────────────────────┐
       │ 3.0 │░░░ SETTING UP ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
       └─────┴──────────────────────────────────────────────────────────┘

       DVCopy  comes with  a generic  SETUP utility  (DSETUP.EXE). Using
       the setup you will be  able to have default configuration options
       built-in  into  DVCOPY.EXE,  you  will   be  able  to  print  the
       registration  form, and  then, when  time comes,  to install your
       key. SETUP is  also capable of verifying that  your DVCOPY.EXE is
       indeed original, and contains no patches or changes in its code.

       When running DSETUP, it will  need to locate DVCOPY.EXE. In order
       to  help  it  locate  DVCopy,  put  DVCOPY.EXE  in  your  current
       directory, or in any of your PATH directories.

       Once DSETUP  was loaded, it will  display a menu. Use  the cursor
       keys  to move  the highlighter,  and [ENTER]  to choose.  You may
       also use  your mouse, if  a you have  one, and a  mouse-driver is
       loaded.

       The menu options are:

       - Sharing Under DESQview.


                                     - 3 -
  DVCopy 0.50       DESQview and SHARE Aware Copy Command       USER MANUAL




       This will toggle whether or  not DVCopy will, on default, attempt
       to share files  when DESQview is detected. DVCopy  will avoid any
       sharing if SHARE is not loaded.


       - Sharing outside DESQview.

       This will toggle whether or  not DVCopy will, on default, attempt
       to share files  when DESQview is not detected.  DVCopy will avoid
       any sharing if SHARE is not  loaded. Usually, this is not needed,
       but  if you  run a  Local Network  (LAN), you  might find it very
       handy.


       - Floppy Protection Level.

       This will cycle the protection  level which DVCopy will use, when
       using floppies.  Note that the  DVCOPY environment variable  will
       override   this  default,   if  found.   Floppies  Protection  is
       discussed later on.


       - Integrity Check DVCOPY.EXE.

       This  option will  check the  integrity of  DVCOPY.EXE, and  will
       report  if it  has been  changed. If  it reports  DVCOPY has been
       changed, you might  want to get another unmodified  copy, as this
       one is probably patched, corrupted or even virus-infected.


       - Print Registration Form.

       This option  will print the  registration form to  printer (PRN).
       Use  it  when  you  want  to  register  DVCopy. Information about
       registering DVCOPY can be found in DVCOPY.REG.


       - Install Registration Key.

       Use  this option  after you  register DVCopy,  once you  get your
       personal registration key  from us. You will be  requsted to type
       in  the key  you have  received. Once  the key  is installed, you
       DVCopy will be registered. Note  that there are no extra features
       in  a   registered  DVCopy,  and   no  crippled  features   in  a
       non-registered DVCopy.


       - Clone Changes (Save).

       Choose this  option after you  have changed anything  in DVCopy's
       config,  and  you  want  to  burn  it  into  DVCOPY.EXE.  This is
       required after changing the 3  first options, or after installing
       a registration key, if you want to keep the changes.



                                     - 4 -
  DVCopy 0.50       DESQview and SHARE Aware Copy Command       USER MANUAL




       - Return to DOS.

       Will return you to DOS.














       ┌─────┬──────────────────────────────────────────────────────────┐
       │ 3.1 │░░░ USING DVCOPY ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
       └─────┴──────────────────────────────────────────────────────────┘


       DVCopy  is very  simple to  use. Running  it with no command-line
       parameters  will cause  it to  display how  to use it. Generally,
       the command line format is  same as MS-DOS's (or 4DOS's) built-in
       COPY.

       There are 3 ways to use it:


       A) DVCOPY.EXE [Original File Specs] [Destination Drive/Dir]

         DVCopy  will  copy  files  from  [Original  File  Specs] to the
         [Destination   Drive/Dir]    directory/drive.   DVCopy   allows
         Wildcards to be used.


       B) DVCOPY.EXE [Original File Specs]

         DVCopy  will  copy  files  from  [Original  File  Specs] to the
         current drive/directory. DVCopy allows Wildcards to be used.


       C) DVCOPY.EXE [Original File Specs] [Destination File Specs]


       Examples:

          DVCOPY A:.

       Copy  all files  from current   directory of  drive A  to current
       drive/directory.




                                     - 5 -
  DVCopy 0.50       DESQview and SHARE Aware Copy Command       USER MANUAL




          DVCOPY D:\TASM\*.ASM A:\

       Copy *.ASM from D:\TASM to drive A's root.


          DVCOPY \UTILS\ARCS\.

       Copy all files from directory \UTILS\ARCS\ to current directory.

          DVCOPY \FD\INBOUND\0*.* \FD\BACKUP\PACKET.*

       Copy all  files from directory \FD\INBOUND\,  which begin with 0,
       to  directory  \FD\BACKUP,  using  file-name  PACKET, keeping the
       original  extension.   There  are  more   complicated  forms  for
       wildcarding,  and DVCopy  supports them  all -  just like  MS-DOS
       does.  Note   that  DVCopy  does  NOT   support  4DOS's  extended
       wildcarding ... Yet.













       ┌─────┬──────────────────────────────────────────────────────────┐
       │ 3.2 │░░░ REQUIREMENTS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
       └─────┴──────────────────────────────────────────────────────────┘


       DVCopy requires the following in order to run correctly:

       IBM PC  AT 80286, 386,  486 or compatible  machine. V20/V30 based
       machines (XTs) can also be  used, but 8088/86 based machines will
       NOT be able to run DVCopy,  or any other executable included with
       this archive.

       MS-DOS 3.1 or newer. DVCopy will also run on 4DOS, or NDOS.

       SHARE loaded (optional). If you are using DESQview, it is strogly
       recommended you load SHARE (will be discussed later). DVCopy will
       work with  or without SHARE, but  will warn if DESQview  is used,
       and SHARE is not loaded.








                                     - 6 -
  DVCopy 0.50       DESQview and SHARE Aware Copy Command       USER MANUAL



       DVCopy  was  tested  on  V20,  80286,  80386sx, 80386dx and 80486
       Microprocessors. It  was tested under DESQview  2.26 to 2.41, and
       QEMM-386 5.12 to 6.02 (Including it's stealth technology). It was
       tested under  MS-DOS 3.30 and 5.00  (Also loaded-high), and under
       4DOS  3.02 to  4.00 (Including  the 18-11  update). It was, also,
       tested  on HyperDisk  4.21 to  4.30 (SHAREWARE).  All and  any of
       these tests performed as expected.












       ┌─────┬──────────────────────────────────────────────────────────┐
       │ 4.0 │░░░ FILE SHARING ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
       └─────┴──────────────────────────────────────────────────────────┘


       When  running more  than 1  program at  the same  time, there  is
       always  the possibility  that more  than one  program will  use a
       specific file at the same time.  No harm is done if both programs
       read the  same file. However,  if any of  them, or even  both, is
       modifying the file, the file will most likely be damaged.

       The  solution, is  file-sharing.  In  order to  make file-sharing
       work,  SHARE has  to be  loaded, and  all participating  programs
       should be share aware. DVCopy does.

       If a task  which is not share-aware is being  used, and is trying
       to  write to  any of  the files  DVCopy uses,  DOS will  deny its
       write-request. Share-aware program would recognize the reason DOS
       doesn't let it write into the file, and act accordingly (wait). A
       non share-aware program would  recognize the write-deny as error,
       and warn you about this, or even quit (depends on the program).


       DVCopy uses the following sharing-modes on the following files:


       - Original-File reading

       When DVCopy  opens the original  file, it will  open it for  read
       purpose only, so other programs, who needs to read-only this file
       will be  able to do so.  If the original file  is already opened,
       and  access to  it is  denied, DVCopy  will wait  until access is
       available.


       - Destination-File writing


                                     - 7 -
  DVCopy 0.50       DESQview and SHARE Aware Copy Command       USER MANUAL




       When DVCopy opens the destination file, it will open it for write
       purpose only. It  will also make sure other  programs will not be
       able to access this file AT ALL.


       NOTE:  When DVCopy  recognizes a  file which  is locked (by other
       program that supports  SHARE, and is using that  file at the same
       time) it will  wait 1 second, and retry. If  after 15 retries the
       file is still locked, it will continue with the next file.


       A good  demonstration of  the file   sharing can  be done  in the
       following way:

       Copy files using  DVCopy from Directory A to  Directory B, and on
       the other task, copy using DVCopy  the same file from Directory B
       to Directory C. You will see  how the second copy of DVCopy (Task
       2) will wait until access to the file is free.












       ┌─────┬──────────────────────────────────────────────────────────┐
       │ 5.0 │░░░ FLOPPY PROTECTION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
       └─────┴──────────────────────────────────────────────────────────┘


       This  is  probably  the  most  appealing  feature  in DVCopy, its
       ability to use floppy drives without causing DESQview to freeze.

       DVCopy support  6 levels of  protection, which provides  you most
       combinations you might want. The  higher the protection level is,
       the  slower  floppies  will  work,  and  the better DESQview will
       perform.  Here is  a brief   list of  the protection  levels, and
       recommendetions:

       - Protection Level 0

       Provides no protection to floppies.  Use this if, for any reason,
       you don't want DVCopy ever protect DESQview from slowness.


       - Protection Level 1





                                     - 8 -
  DVCopy 0.50       DESQview and SHARE Aware Copy Command       USER MANUAL



       Provides  minimal, even  too-minimal  protection.  If the  CPU is
       100%  busy,  speed  will  decrease  in  30%  maximum  (i.e. Total
       copying time will be 130%, if  regular COPY is 100%). DVCopy will
       not try  to keep DESQview  warm all time,  but will drop  it some
       power from time to time.


       - Protection Level 2

       Provides  poor protection.  If the  CPU is  100% busy, speed will
       decrease in 50% maximum. Use  this when using high-speed floppies
       (usually  5.25"), when  the computer  is running  unattended, and
       there  is  no  need  for  synchronized  operation (i.e. NOT while
       transferring files via a modem or a serial port).


       - Protection Level 3

       Provides  standard protection.  If the  CPU is  100% busy,  speed
       will decrease in 55% maximum.  Will attempt to keep DESQview warm
       all the time.  Can be used on regular  speed (2400BPS) transfers,
       or  high-speed transfers,  if buffered  UART is  used (i.e.  FIFO
       NS16550AFN). DVCopy 0.20 used this mechanism of protection.


       - Protection Level 4

       This  provides   a  combination  between  Level   3  to  level  5
       protection  (which will  be discussed  later on).  If the  CPU is
       100%  busy,  speed  will  decrease  in  92%  maximum.  Will  keep
       DESQview warm and flowing.  Recommended when copying-speed is not
       critical.  On slow  drives (3.5"  usually) will  work better than
       Level 3.


       - Protection Level 5

       This level  provides top-protection. It  is very likely  you will
       not even notice any speed reduces.  On a 100% busy CPU, will slow
       down the system in 146%.  Is recommended when running many tasks,
       and   /    or   DESQview   requires    synchronized   time-slices
       (file-transfer, BBS, etc). Use this  level when DESQview speed is
       really  important,  and  copying  speed  is  not  critical.  This
       protection level  will continously give  DESQview power, and  not
       in bunches.


       DVCopy will  use the protection  level that is  set using DSETUP,
       as  default.  You  may  override   this  default  by  setting  an
       environment variable,  called DVCOPY, which will  contain the new
       protection  level. An  invalid  value  in the  DVCOPY environment
       variable will  cause DVCopy to use  the default protection level,
       which was set in DSETUP.




                                     - 9 -
  DVCopy 0.50       DESQview and SHARE Aware Copy Command       USER MANUAL





       ┌─────┬──────────────────────────────────────────────────────────┐
       │ 6.0 │░░░ TRADEMARKS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
       └─────┴──────────────────────────────────────────────────────────┘

       The following are trademarks,  registered trademarks  and  efforts
       of their authors (alphabetical order):

        4DOS              Rex Conn, J.P. Software.
        QEMM-386,
        DESQview          Quarterdeck Office Systems.
        MS-DOS            Microsoft Corp.
        NDOS              Symantec Corp.
        HyperDisk         HyperWare.







       ┌─────┬──────────────────────────────────────────────────────────┐
       │ 7.0 │░░░ HOW TO CONTACT US ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
       └─────┴──────────────────────────────────────────────────────────┘


       If  you  have  any  comments,  reports  about  bugs,  or you just
       interested  in  support,  you  can  contact  the  author  at  the
       following ways:


       FidoNet             NetMail           2:403/139.75.
                           DESQview Intl. Echo (DESQVIEW).


       Support Boards      The Black Universe  2:403/139.0
                           [phone] / [phone]
                           2400MNP5, 24 Hours.
                           Sysop: Saar Blitz.

                           Triple D BBS        2:403/123.0
                           [phone]
                           14.4k USR Dual-Standard, 24 Hours.
                           Sysop: Roy Udassin.

                           Fre'qable from both using magic name DVCOPY.



       SnailMail           Yossi Gottlieb
                           (YossiWare Developments)
                           11 Armonim St.
                           Ramat-Gan 52587
                           ISRAEL


                                     - 10 -